# Hole-Installer
## An user-friendly installer of shadowsocks-rust and v2ray-plugin for Windows and Linux systems, designed because of, and for Iran internet censorship, but works everywhere.
## Why?
Good question, why?

Because my people are dying, being tortured and bravely defending their rights. Making their ***much*** limited access to Internet (**International** Network) a bit wider, is the least and the best I can do.

And Iran is not the only country suffering dictatorship, maybe this project comes handy for other people. 

Note : This is not a "free VPN", You still need the server ready.
## Code is messy!
Yep, and what did you expect?

This was a shot in the dark to make building fake and spyware-installer scripts more difficult(Which also burns the contributors land, unfortunately)

And plus to that, this code is written in 3 days and aimed to be compatible and working, not to be beautiful.
## How to install?
Pretty simple, clone this repository from anywhere you are viewing, or use release pages (if exists, link in this page probably), download the script (python required) or binary file.

### Notice this, the only git sources I approve and maintain, and you can consider as "safe" to download the script:
[Radicle, Decentralized Git](https://app.radicle.network/seeds/pine.radicle.garden/rad:git:hnrkgwf7i3ya1bgup9xm5tf4urnsjf5bfnkbo)

[NotABug repository](https://notabug.org/govlock/Hole-Installer)
 
### The list of approved torrents will be updated in this README, I can't update them in torrent files, so look for magnet links in the mentioned repositories.




Run it. It does everything automatically, You just have to enter a Shadowsocks link in the latest step.

And every time you want to use it, run `Shadowsocks` through CMD or RUN in **Windows** or terminal on Linux. Then set your HTTP proxy to `127.0.0.1:8118`.

To make your connection normal again, close `shadowsocks` (With `Ctrl+C`, `Ctrl+Z` etc., your preferred way). And unset the proxy.

EZ.

To uninstall you have to erase the only traces of this project. `.shadowsocks` folder in your home directory, and the directory in PATH (which woudn't do anything even if you leave it as it is, If you don't know what I'm talking about, the best is to leave it).

## License
AGPL v3.0.

Easy explanation of my point to choose this license :

If you change anything, and you are going to share it with others, you should make your changes public, and include a copy of `LICENSE` file.

This also applies if you changed the code to use on a server (for some reason) and are going to present others with the result of this script.

